home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat2 / standard / signal.z / signal
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSIIIIGGGGNNNNAAAALLLL((((2222))))                                                            SSSSIIIIGGGGNNNNAAAALLLL((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      signal - software signal facilities (System V)
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssiiiiggggnnnnaaaallll....hhhh>>>>
  13.  
  14.      _CCCC_::::
  15.        vvvvooooiiiidddd ((((****ssssiiiiggggnnnnaaaallll ((((iiiinnnntttt ssssiiiigggg,,,, vvvvooooiiiidddd ((((****ffffuuuunnnncccc))))(((())))))))))))(((())));;;;
  16.      _CCCC_++++_++++_::::
  17.        vvvvooooiiiidddd ((((****ssssiiiiggggnnnnaaaallll ((((iiiinnnntttt ssssiiiigggg,,,, vvvvooooiiiidddd ((((****ffffuuuunnnncccc))))((((iiiinnnntttt))))))))))))((((iiiinnnntttt))));;;;
  18.  
  19.      _####_iiii_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  20.        vvvvooooiiiidddd ((((****ssssiiiiggggnnnnaaaallll ((((iiiinnnntttt ssssiiiigggg,,,, vvvvooooiiiidddd ((((****ffffuuuunnnncccc))))((((iiiinnnntttt))))))))))))((((iiiinnnntttt))));;;;
  21.      _####_eeee_nnnn_dddd_iiii_ffff
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _ssss_iiii_gggg_nnnn_aaaa_llll allows the calling process to choose one of three ways in which it
  25.      is possible to handle the receipt of a specific signal.  _s_i_g specifies
  26.      the signal and _f_u_n_c specifies the choice.
  27.  
  28.      For a list of valid signals and a general description of the signal
  29.      mechanism please see _ssss_iiii_gggg_nnnn_aaaa_llll(5).
  30.  
  31.      [EINVAL]  _ssss_iiii_gggg_nnnn_aaaa_llll will fail if _s_i_g is an illegal signal number, including
  32.                SSSSIIIIGGGGKKKKIIIILLLLLLLL and SSSSIIIIGGGGSSSSTTTTOOOOPPPP.
  33.  
  34.      [EINVAL]  _ssss_iiii_gggg_nnnn_aaaa_llll will fail if an illegal operation is requested (for
  35.                example, ignoring SSSSIIIIGGGGCCCCOOOONNNNTTTT, which is ignored by default).
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      kill(1), intro(2), blockproc(2), kill(2), pause(2), ptrace(2),
  39.      sigaction(2), sigset(2), wait(2), setjmp(3C), sigvec(3B),
  40.      pthread_kill(3P), signal(5)
  41.  
  42. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  43.      Upon successful completion, _ssss_iiii_gggg_nnnn_aaaa_llll returns the previous value of _f_u_n_c for
  44.      the specified signal _s_i_g.  Otherwise, a value of _SSSS_IIII_GGGG______EEEE_RRRR_RRRR is returned and
  45.      _e_r_r_n_o is set to indicate the error.  _SSSS_IIII_GGGG______EEEE_RRRR_RRRR is defined in the header
  46.      file <_s_y_s/_s_i_g_n_a_l._h>.
  47.  
  48. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  49.      Signals raised by the instruction stream, SSSSIIIIGGGGIIIILLLLLLLL, SSSSIIIIGGGGEEEEMMMMTTTT, SSSSIIIIGGGGBBBBUUUUSSSS, SSSSIIIIGGGGSSSSEEEEGGGGVVVV
  50.      will cause infinite loops if their handler returns, or the action is set
  51.      to SSSSIIIIGGGG____IIIIGGGGNNNN....
  52.  
  53.      The POSIX signal routines (_s_i_g_a_c_t_i_o_n(2), _s_i_g_p_e_n_d_i_n_g(2), _s_i_g_p_r_o_c_m_a_s_k(2),
  54.      _s_i_g_s_u_s_p_e_n_d(2), _s_i_g_s_e_t_j_m_p(3)), and the 4.3BSD signal routines (_s_i_g_v_e_c(3B),
  55.      _s_i_g_n_a_l(3B), _s_i_g_b_l_o_c_k(3B), _s_i_g_p_a_u_s_e(3B), _s_i_g_s_e_t_m_a_s_k(3B)) must NEVER be
  56.      used with _s_i_g_n_a_l(2) or _s_i_g_s_e_t(2).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSIIIIGGGGNNNNAAAALLLL((((2222))))                                                            SSSSIIIIGGGGNNNNAAAALLLL((((2222))))
  71.  
  72.  
  73.  
  74.      Before entering the signal-catching function, the value of _f_u_n_c for the
  75.      caught signal will be set to SSSSIIIIGGGG____DDDDFFFFLLLL unless the signal is SSSSIIIIGGGGIIIILLLLLLLL,
  76.      SSSSIIIIGGGGTTTTRRRRAAAAPPPP, or SSSSIIIIGGGGPPPPWWWWRRRR.  This means that before exiting the handler, a _ssss_iiii_gggg_nnnn_aaaa_llll
  77.      call is necessary to again set the disposition to catch the signal.
  78.  
  79.      Note that handlers installed by _ssss_iiii_gggg_nnnn_aaaa_llll execute with _n_o signals blocked,
  80.      not even the one that invoked the handler.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.